home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / wb / czesc_4 / sizer / readme < prev    next >
Text File  |  1992-07-23  |  3KB  |  83 lines
  1. INTRODUCTION
  2.  
  3.      Sizer reports the size of selected disk objects (including
  4. subdirectories).  It reports the number of bytes in all plain files and the
  5. number of blocks occupied by files and directories.  It is intended for the
  6. Workbench user who wants to know if there is room to drag-copy one or more
  7. icons.
  8.  
  9.      I wrote Sizer for three reasons.  First, I wanted it for my own use. 
  10. Second, I wanted to learn how to use the Workbench startup module.  Third, I
  11. wanted to learn how to examine the contents of directories using Examine()
  12. and ExNext().
  13.  
  14.  
  15. INSTRUCTIONS
  16.  
  17.      Sizer works only from the Workbench.  If started from the CLI it will
  18. terminate without doing anything.
  19.  
  20.      Select Sizer and all the objects you want sized using extended
  21. selection.  Click once on the Sizer icon.  Hold down the shift key and
  22. select the objects you want sized.  Double-click on the last one.  Sizer
  23. will open a window and show you the number of bytes and blocks.  While Sizer
  24. is working the numbers will keep changing.  When it finishes it will write
  25. "Program completed.  Select close gadget to exit." into the window.  If the
  26. program fails for some reason it will indicate "Program failed.  Select
  27. close gadget to exit."
  28.  
  29.      While Sizer is running you can cancel it by selecting the close gadget. 
  30. Sizer will stop executing and close the window.
  31.  
  32.  
  33. WARNINGS
  34.  
  35.      Sizer calculates blocks for the old file system (OFS) and the fast file
  36. system (FFS).  Information about the file systems' overhead is coded in the
  37. program.  Sizer's block counts do not apply to any other file systems.
  38.  
  39.      Because the Amiga is a multitasking system, the size of a file can
  40. change at any time.  Keep this in mind when using the information Sizer
  41. gives you.
  42.  
  43.  
  44. DISTRIBUTION
  45.  
  46.      Sizer is in the public domain.
  47.  
  48.  
  49. AUTHOR
  50.  
  51. --Fabbian G. Dufoe, III
  52.    350 Ling-A-Mor Terrace South   | GEnie:    F.DUFOE3
  53.    St. Petersburg, Florida  33705 | internet: fgd3%nifty@tct.com
  54.    813-823-2350                   | uucp:     ...tct!deep6!nifty!fgd3
  55.  
  56.  
  57. REVISION HISTORY
  58.  
  59. 15 October 1991: Initial release, version 1.0.
  60.  
  61. 18 May 1992: Version 1.1
  62.    If address 0 contained a non-zero value Sizer would fail when it
  63.    encountered a directory within a directory.  The problem was a function
  64.    call that passed a NULL pointer instead of a pointer to a NULL string.
  65.    It was a dumb mistake, but it's been fixed.
  66.  
  67. 13 June 1992: Version 1.2
  68.    Sizer used the number of blocks in the FileInfoBlock (fib_NumBlocks) to
  69.    accumulate its block count.  There are several problems with that
  70.    approach.  First, directories on disk have fib_NumBlocks set to 0
  71.    (for directories on RAM: it is 1) but directories take up one block of
  72.    disk space each.  Second, the number of blocks required for a given file
  73.    may vary depending on whether the file is written to an old file system
  74.    (OFS) or fast file system (FFS) disk.  The block size is different.
  75.    Knowing how many FFS blocks a disk object occupies doesn't tell you
  76.    (easily) how many OFS blocks it will require.
  77.  
  78.    By calculating the blocks from the block size and the number of bytes in
  79.    the file I solved both problems.  Sizer now reports the number of blocks
  80.    correctly whether the object being sized is on disk or RAM:.  Sizer gives
  81.    you both the number of OFS blocks and FFS blocks.
  82.  
  83.